RTOS-Link™ 

Real-Time Development, Debug and Measurement for pSOS+ 



Applied Microsystems introduces RTOS-Link™ 
the next step in a new level of embedded 
systems development tool interoperability. 
RTOS-Link is a software support package that provides 
integration of pSOS+ kernel awareness with Applied's 
MWX-ICE source-level debug and emulation environments. 

This integrated tool will help you pinpoint common, 
yet difficult to find software/hardware integration 
problems at the task level. A quick, one-time link to your 
application eliminates recurring setup hassles. No one 
provides a more complete environment for your real- 
time OS-based development, debug and integration needs. 

Trace Run-Time/OS Interactions 

• Understand how pSOS activity and interrupts affect 
the flow of your application 

• Trace all pSOS service calls, including input and 
output parameters 

• Trace all return codes 

• Trace all error messages 

• Capture and display all task switches 

• Track execution time for each task timeslice 

• pSOS trace information is translated into textual 
description with native pSOS mnemonics 



RTOS-Link — bringing intelligence 
to real-time development. 




Profile OS Operation 

• Profile task by: pSOS clock ticks, time in task, and 
percentage of system time tasks are active 

• Display data in histogram or statistical formats 

• Clear accumulated profile data on command 



Track Dynamic OS Activity 

• Track all creation and deletion of dynamic pSOS objects 

• Detect attempts to free invalid memory partitions 
and regions 

• Track all dynamic allocation and deallocation of memory 
Monitor OS Objects 

• Display node, component, and object configuration tables 

• Display summary information for all tasks, queues, 
regions, partitions and semaphores 

• Display detailed information for individual tasks, 
queues, regions, partitions and semaphores 

• Displays full task contexts including size location and 
current status of stacks 

Uncover Problems Based on OS Activity 

• Detect task stack overflow conditions 

• Set hardware and software task-qualified breakpoints 
using symbols 

• Stop if any pSOS service call generates an error 

• Trigger breakpoints based on a switch to a given task 
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Debugging an embedded system can be a complex 
task, and trying to understand the application 
interaction with the OS and target at run-time can 
add to the difficulty. Since you have invested in a real-time 
operating system for efficiency and productivity, it makes 
sense to move kernel awareness into your emulation 
environment as well. By including RTOS-Link with Applied's 
emulators, you quickly gain easy access to a variety of 
capabilities to help you view your system at run-time from 
the task level thereby improving your productivity and time 
to market. 

Tracking Dynamic pSOS+ Activity 

Following the dynamic usage of OS objects and memory 
allocation has always been a difficult problem. RTOS-Link 
allows you to track activities such as the creation and 
deletion of dynamic objects and memory allocation as it 
occurs in your system. This can be very useful for tracking 
the size and location of memory regions and partitions 
when the system allocates memory. You will also be able to 



For more information: 
Call 1-800-426-3925; E-Mail info@amc.com; 
Browse http://www.amc.com 



detect attempts at freeing invalid 
memory segments. 

Was it perhaps a corrupt pointer? 
Maybe the wrong object ID? By 
tracking the values of all input and 
output parameters to OS service calls, 
you can quickly pinpoint the cause of 
any dynamic pSOS+ activity problems 
as the kernel interacts with your 
target application. 



performance. 



Tracing Run-Time 
pSOS+ Interactions 

RTOS-Link, in conjunction with the 
real-time trace acquisition systems of 
Applied's emulators, allows you to 
track and measure the run-time OS 



— 



File Edit Windows Notebooks View 



? (Ill 



Steplnstr 



StepO Instr 
Go 



TSK9 OOObOOOO* 13 2002 Wait (evt = 00000004) 
Stack Initial Current End Free 



flDDR 0004bf34 OOOoooi'i. ............... 00000000 

DP.TP, 00000000 00000000 00000004 OOOcuhbi: 2 00000000 

USER 00000000 00000000 00000000 00000OC Oiioooooo 000. .0. .0. . 

SYS 00000000 oooooooo oooooo... 



SR = 2000 Format/Vector Offset = OOac 
Pending Events = 00000000 

Pending flSR = 00000000 RSR flddr = 00000000 RSR Mode = 0000 
Initial Prio = 13 Initial Mode = 2002 



Event Every: TMID = 00000000 Events = 00000004 Ticks left = 00000202 Qrig = 00000bb8 



An itemized display of pSOS+ task information provides task context information, 
status, pending activities, timers, ASR and task stack detail. 



Profiling pSOS+ 
Tasking Operations 
RTOS-Link provides a convenient 
method for profiling the tasks in your 
system. You can display data in an 
easy to read histogram, or in a 
statistical format that includes 
accumulated pSOS+ clock ticks, time 
in tasks, and the percentage of total 
system time the tasks were active. 

These measurements make finding 
software bottlenecks much easier. 
You want your system performing in 
synch. Task-based profiling allows 
you to visualize potentially over- 
utilized functions. Profiling can also 
aid in the detection of system 
thrashing, where task switching and 
control mechanisms are not being 
utilized for optimal system 
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interaction and task flow occurring in 
your system. When using a monitor/ 
debugger, you can not determine 
how your system got to a particular 
state or where it went subsequently. 
The trace capability of RTOS-Link 
solves this problem. 

When task switches occur, the 
trace window conveniently displays 
each task timeslice in individual text 
blocks. The real-time, timestamping 
mechanism determines the amount of 
time the application spent executing 
in a particular task. This can be useful 
for understanding and measuring the 
timing required for individual tasks 
and response to inter-task 
communication, such as posting 
semaphores and responding to events. 

You can also easily switch between 
tracing at the source, disassembled, 
bus-level or mixed modes and OS activity. 



Uncovering Problems 
Based on pSOS+ Activity 
By linking Applied's real-time break 
and event system capabilities with 
pSOS+ interaction, you have a variety 
of tools to help you isolate problems 
that may creep up as you integrate 
your application with the OS and target. 

Since you may have many tasks that 
all call a given service routine, RTOS- 
Link's task-qualified breakpoint 
capability will help you quickly weed out 
the culprit through a combination of 
RAM-based software execution 
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Task Profiling Statistics 



Name 

ISLE 
ROOT 

IS! a 

TSK2 
0x12345679 
TSK4 
TS!5 
TSiit- 
TSI7 
TSK8 
V_.VS 



An example statistical profile ofpSOS 
names, accumulated pSOS+ timer ticks, 
system execution 



+ tasking activity displays symbolic task 
execution time translation, and percentage 
time spent per task. 



task-based problem can quickly be 
narrowed by stopping on the occurrence 
of a switch into a particular task. 

Another useful capability is the 
means to stop emulation when 
pSOS+ returns an error code. This 
can be very useful during integration 
when you begin debugging time- 
critical interactions within the 
system. Furthermore, during the test 
phase of your project, you may be 
quite confident of the interaction 
between the OS and the target 
application, but you will certainly 
want to know if an unusual error in 
OS activity occurs during long burn-in 
test periods. 

Perhaps one of the most difficult 
problems to track down is when one 
of your task stacks overflows. It's 
usually way too late to figure out 
what happened to cause your 
application to execute in unexpected 
territory. RTOS-Link provides the 
capability to monitor for a task stack 
overflow condition. When such a 
condition is about to occur, you are 
notified ahead of time, so you can 
examine the state of the task's stacks 
and take corrective action before it's 
too late. 
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A summary display of all objects created in a system, 
including symbolic name, ID and object type. 



Monitoring pSOS+ Objects 

Traditionally, when you move to an 
emulation environment you lose sight 
of all kernel objects in your system. 
RTOS-Link provides the capability to 
monitor the status of all kernel 
objects with which your application 
interacts. 
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Steplnstr 


ENTERING TASK 


TSK5 


Return from trn_uk after; 


SUCCESS 


StepOuer 


Gal 1 to pt_getbuf : 


00000000 


- partition IE 


OOOCOOOO 


StepO Instr| 


- buffer address 


00001B34 




Return from pt.getbuf: 


SUCCESS 


Go 


Call to pt_retbuf: 


00000000 


Stop 


- partition ID 


OOOCOOOO 


- buffer address 


00001B34 




Return from pt.retbuf: 


SUCCESS 


Print 


Gal 1 to tm uikafter; 


00000000 




- ticks 


00000708 




EXITING TASK 


TSK5 




time spent in task 


2.904s 




ENTERING TASK 


TSK4 




Cal 1 to pt.retbuf ; 


00000000 




- partition IE 


OOOCOOOO 




- buffer address 


00001B14 




Return from pt_retbuf : 


SUCCESS 




Call to t_suspend; 


00000000 




- task ID 


00000000 




EXITING TASK 


TSK4 




time spent in task 


2.807s 




ENTERING TASK 


TSKl 




Return from sm_v; 


SUCCESS 




Cal 1 to sm_create: 


00000000 






SEM4 




- semaphore start value 


00000000 




- semaphore flags 


SM_GL0BAL*SM_PRI0R 




- semaphore IE 


00130000 




Return from sm_create: 


SUCCESS 




Cal 1 to pt_getbuf : 


00000000 




- partition IE 


OOOCOOOO 




- buffer address 


00001B14 




Return from pt.getbuf : 


SUCCESS 




EXITING TASK 


TSKl 




time spent in task 


952.246ms 



Enter Command: | I 



Input Radix: Decimal Hex Output Radix 



Often a summary of kernel objects 
is sufficient. With RTOS-Link, you 
have the option of seeing summary- 
level detail of all pSOS+ objects in 
the system, or summary-level detail of 
any group of particular objects, such 
as tasks, queues, semaphores, 
partitions or regions. 

Sometimes more detail is 
required, so you also have the ability 
to request detailed information about 
any structure in your system. This is 
very useful for debugging at the task- 
level, where you need to know 
information about specific task 
contexts, task pending and ready 
status, and the size, location and 
current positioning of local stacks. 



Trace flow of pSOS+ activity provides 
descriptive information about your service calls. 



RTOS-Link from Applied 
Makes It Simple 

To improve your productivity, you need 
tools that are not only powerful, but 
easy to install and use. RTOS-Link can 
quickly be added to your application 
just once, eliminating setup problems 
that compromise solutions impose. 
Because RTOS-Link is an integrated 
software package for the MWX-1CE 
environment, it installs 
easily into your existing software 
directory structure. 

Perhaps you are familiar with the 
pROBE and ESp debugging tools from 
I SI . Becuase they are software-based, 
you can use them concurrently with 
Applied's emulation environment and 
RTOS-Link. In fact, you could have 
them running on the same workstation 
if you'd like. Since Applied's emulation 
environment can be accessed 
seamlessly across the network, you 
can have convenient access to your 
target environment from anywhere on 
your network. 

RTOS-Link transparently supports 
both versions 1 .2 and 2.0 of pSOS + . 
The RTOS-Link software will determine 
which version of pSOS+ your target is 
running, and will make the appropriate 
control adjustments. 



Helping You Succeed 

Because our success depends on your 
success, we take product support very 
seriously. Applied has the qualified and 
committed people it takes to provide 
superior engineering assistance, 
technical guidance on emulation issues 
and expedited product service. Our 
Applications Engineering Group is 
backed by a network of experienced 
Field Applications Engineers, our own 
design teams, and the commitment of 
the entire company. And with over 
16,000 installed solutions and more 
than fifteen years of leadership in 
embedded hardware and software 
development tools, our team is an 
important asset to have on your team. 



Compatibility 

RTOS-Link for the pSOS+ real-time 
operating system is a software option 
for Applied Microsystems emulation 
environments. An Applied 
Microsystems emulation environment 
is required to use RTOS-Link. 
Contact Applied for a list of currently 
supported microprocessors and 
microcontrollers. RTOS-Link supports 
both versions 1.2 and 2.0 of pSOS + . 



Software Support 

Applied Microsystems provides 
software upgrades through purchase of 
a software support contract. Contact 
your Applied Sales Representative for 
more information. 



Take the Time to Call Now 

To see how RTOS-Link for pSOS+ can 
help you increase productivity, call 
1-800-426-3925 for information or a 
product demonstration. 
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U.S. and Canada 

Applied Microsystems Corporation 

5020 148th Avenue N.E. 

P.O. Box 97002 

Redmond, WA 98073-9702 

Tel: 206-882-2000 

Toll-Free: 1-800-426-3925 

TRT Telex 185196 

Fax: 206-883-3049 

Europe 

Applied Microsystems Corporation Ltd. 

AMC House, South Street 

Wendover, Buckinghamshire, HP22 6EF 

United Kingdom 

Tel: +44 (0)1296-625462 

Fax: +44 (0)1296-623460 

Germany 

Applied Microsystems GmbH 
Stahlgruberring 11a, 81829 Muenchen 
Germany 

Tel: +49 (0)89-427-4030 
Fax: +49 (0)89-427-40333 
Japan 

Applied Microsystems Japan, Ltd. 

Arco Tower 1 3 F 

1-8-1 Shimomeguro, Meguro-ku 

Tokyo 153 

Japan 

Tel: +81-3-3493-0770 
Fax: +81-3-3493-7270 



For more information, call 1-800-426-3925, 

e-mail info@amc.com,or browse http://www.amc.com 
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